home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / rap101.zip / UPDATES.LST < prev   
File List  |  1988-11-05  |  7KB  |  161 lines
  1.                       Changes from previous versions of RAP
  2.                       =====================================
  3.  
  4. Version 1.01 - 11/5/88
  5.  
  6.     Fixes a bug in the handling of very long PATH lists and file names.
  7.  
  8.  
  9. Version 1.00 - 11/2/88
  10.  
  11.     This is the first formally-released version of RAP.  It incorporates many
  12.     changes and additions over the field-test versions, including the following:
  13.  
  14.  
  15. Command     Comment
  16. -------     -------------------------------------------------------------------
  17.  
  18. a, ah       These commands no longer use $readbuf; they now place the material
  19.             they read in the specified numeric or text variable only.
  20.  
  21. as          This now places the character read in the specified variable
  22.             instead of in $readbuf.  If that variable is a numeric one,
  23.             the ASCII code for the character read is placed there. 
  24.  
  25. bye         This now takes an optional argument, a number between 0 and 255
  26.             which is returned to DOS as the error code.
  27.  
  28. c           Ordinary assignment has been supplemented with the increment
  29.             and decrement operators ++, --, +=, and -=, and with the
  30.             non-evaluating cs for faster assignment of constants.
  31.  
  32. cls         Replaces the old ch command.  The effect is the same (clearing
  33.             the screen), but the cls abbreviation is more standard.
  34.  
  35. close       Replaces the old closef command, but works the same.
  36.  
  37. debug       When displaying variables and subprogram labels, debug now shows
  38.             only user-defined variables and labels, unless the - prefix  is
  39.             used.  That prefix causes display of built-in symbols too.
  40.  
  41. else/       Parentheses are no longer required around the conditional
  42. else if/    expressions in these statements.
  43. exit if
  44.  
  45. get/        Load and run have replaced get, load, and run, as follows:
  46. load/
  47. run         for this operation:         command was:    command is now:
  48.             -------------------         ------------    ---------------
  49.             read in a program file      get myfile      load myfile
  50.             read it in and run it       load myfile     run myfile
  51.             run a loaded program        run             run
  52.  
  53. list        The p option for printing is no longer supported.
  54.  
  55. loop        Two new forms of loop have been added:  loop <number> times,
  56.             and  loop for <numvar> = <startval> to <endval>.  These allow
  57.             counting loops to be more simply coded, and to run faster.
  58.  
  59. m           The separate match command has been replaced by the string
  60.             comparison operators "has" and "contains".  Both check for presence
  61.             of a pattern in a string; "contains" also sets variables to show
  62.             the string matched and its left- and right- context.  Code using
  63.             these operators is simpler and more intuitive than that using
  64.             the match command.  There is no longer a $readbuf variable.
  65.  
  66.             The abbreviation \b in a match pattern now means backslash,
  67.             eliminating the need for \\\\.  It becomes \\b instead.
  68.  
  69. *open       This built-in function replaces the old openf command.  New
  70.             access modes are supported, and the searching rules have been
  71.             extended.
  72.  
  73. read        The read operation places material read into the specified variable,
  74.             and not into a built-in $readbuf variable.
  75.  
  76. return      Parentheses are no longer required around a numeric argument.
  77.             If the return value argument is a string function or string 
  78.             variable, quotes are no longer required around it.
  79.  
  80. rl          This command has been removed.
  81.  
  82. poke        The address argument to this command now specifies an absolute
  83.             address, rather than one relative to the current data segment.
  84.  
  85. proc,              These three constructions have replaced the subroutine.
  86. numeric function,  You now explicitly identify a subprogram as returning
  87. string function    a number, returning a string, or not returning a value.
  88.  
  89. end proc,          These commands have replaced "end subroutine".
  90. end function
  91.  
  92. ts, tsh     These non-evaluating forms of t and th have been added.
  93.  
  94. vsave,      These commands now save and restore global user-defined variables
  95. vrestore    only, and not built-in or local ones.
  96.  
  97.  
  98.  
  99. Built-in
  100. Functions
  101. ---------   -------------------------------------------------------------------
  102. *envir      This new built-in function retrieves the value of a DOS environment
  103.             variable.
  104.  
  105. *escape_symbols    This was formerly called *txescape.
  106.  
  107. *fileymdt   This new function returns the date and time of a file in a
  108.             sortable format.
  109.  
  110. *final_eval This was formerly called *txfinal.
  111.  
  112. *findpath   This new function searches for a file using the current $path,
  113.             and returns the actual path by which it found the file.
  114.  
  115. *index      This new function reports the position of the first occurrence
  116.             of a specified character in some string.
  117.  
  118. *memfree    Thes new function reports the amount of free memory in bytes.
  119.  
  120. *peek       The address argument to this function now specifies an absolute
  121.             address, rather than one relative to the current data segment.
  122.  
  123.  
  124. Other
  125. Features    Comments
  126. --------    -------------------------------------------------------------------
  127.  
  128. error       There are more error and warning messages, and some of the
  129. messages    existing ones have been reworded for clarity.
  130.  
  131. numbers     Previously, numbers were limited to a maximum of 32767.  Now the
  132.             limit is 2.14 billion.  This simplifies operations pertaining to
  133.             file length and memory size, since no scaling factor is now needed.
  134.             The #fscale variable is no longer used in file operations.
  135.  
  136. numeric     The syntax for numeric expressions is now simpler.  Several
  137. expressions situations that formerly required parentheses no longer do.
  138.             This should help readability, and make it easier to write legal
  139.             programs.
  140.  
  141.             The rem operator has been added, and mod now behaves correctly.
  142.  
  143.             A single equals sign may be used as a comparison operator; RAP
  144.             no longer insists on a double equals.
  145.  
  146. program     When searching for a program to be loaded, SmallRAP tries the
  147. loading     "RPS" extension before "RAP".  LargeRAP tries the "RPL"
  148.             extension before "RAP".
  149.  
  150. screen      You can specify screen type with a DOS environment variable
  151. type        named SCREENTYPE, which may be set to IBM, ANSI, or SHARP.
  152.  
  153. string      Where string function calls are being used as terms in string
  154. expressions comparisons, as calling arguments, or as return arguments, they
  155.             no longer need to be enclosed in quotes.
  156.  
  157. string      When RAP has replaced a variable name or function call while
  158.             evaluating a string, it no longer rescans from the beginning
  159.             of the line.  It just backs up one character from the start
  160.             of the new text, and continues scanning from there.
  161.